home *** CD-ROM | disk | FTP | other *** search
/ .net 2000 August / NET74.ISO / pc / Software / JavaApplet / AnfyMacBeta1.sea / Anfy for Macintosh / anjavapp / tunnel3d / tunnel3d.txt < prev    next >
Encoding:
Text File  |  1999-07-05  |  6.0 KB  |  137 lines  |  [TEXT/ttxt]
  1.  
  2.           Tunnel 3d - Copyright (C) by Fabio Ciucci 1997-99
  3.  
  4.  
  5. This applet can generate a texture-mapped tunnel from any GIF/JPG image, but
  6. different in looks from another tunnel applet.
  7. Thanks for M. Kalms for his useful hints.
  8.  
  9. This applet is fully parametrized, so you can generate various kinds of tunnel
  10. effects.
  11.  
  12. *************************************************************************
  13.  
  14. NECESSARY FILES
  15.  
  16. Together with the tunnel texture and an optional foreground image, the 
  17. following 3 ".class" files must be uploaded: 
  18.  
  19. tunnel3d.class
  20. Lware.class
  21. anfy.class
  22.  
  23. Plus, tunnel3d.jar for speedy loading on recent browsers.
  24.  
  25. *************************************************************************
  26.  
  27. EXAMPLE.
  28.  
  29. Insert the <applet> tag in your html document as follows to add this applet
  30. to your page (Comments after the ";" symbol are code explanations and
  31. acceptable min/max values. They are not part of the applet language):
  32.  
  33.  
  34. <applet archive="tunnel3d.jar" code="tunnel3d.class" width="320" height="192">
  35. <param name="credits" value="Applet by Fabio Ciucci (www.anfyteam.com)">
  36. <param name="regcode" value="NO">         ; Registration code (if you have it)
  37. <param name="reglink" value="NO">         ; Optional URL link when the applet
  38.                                           is "clicked".
  39. <param name="regnewframe" value="YES">         ; Reglink opened in new frame?
  40. <param name="regframename" value="_blank">     ; Name of new frame for reglink
  41. <param name="statusmsg" value="Tunnel3d applet">  ; Statusbar message
  42. <param name="image" value="stone.jpg">       ; Tunnel texture image
  43. <param name="res" value="1">                 ; resolution (1-8)
  44. <param name="lightmin" value="1">            ; Min. lightsoucing (1-127)
  45. <param name="lightmax" value="127">          ; Max. lightsoucing (1-127)
  46. <param name="lightdec" value="18">           ; Light decrementing
  47. <param name="tunnelradius" value="20">       ; Radius of tunnel
  48. <param name="shade" value="YES">             ; Shading ("YES" or "NO")
  49. <param name="lightinv" value="NO">           ; Inverse lightning ("YES" or "NO")
  50. <param name="squared" value="NO">            ; Square instead of spheric (YES-NO)
  51. <param name="tunrot" value="1">               ; Tunnel rotation value
  52. <param name="tunadvance" value="2">           ; Tunnel advancing value
  53. <param name="xrot" value="30">                ; Observer X rotation
  54. <param name="yrot" value="30">                ; Observer Y rotation
  55. <param name="zrot" value="5">                  ; Observer Z rotation
  56. <param name="interactive" value="YES">       ; Interactive mode ("YES" or "NO")
  57. <param name="bends" value="YES">               ; Bends ("YES" or "NO")
  58. <param name="numbends" value="3">              ; Number of bends
  59. <param name="bendoffset" value="0">            ; Bends offset
  60. <param name="bendsizemin" value="0">           ; Bends size min.
  61. <param name="bendsizemax" value="60">          ; Bends size max.
  62. <param name="bendoffsetinc" value="10">        ; Bends offset increment
  63. <param name="bendsizeinc" value="2">           ; Bends size increment
  64. <param name="overimg" value="NO">              ; Optional image over applet
  65. <param name="overimgX" value="0">              ; Over image X offset
  66. <param name="overimgY" value="0">              ; Over image Y offset
  67. <param name="memdelay" value="1000">           ; Memory deallocation delay
  68. <param name="priority" value="3">              ; Task priority (1..10)
  69. <param name="MinSYNC" value="10">              ; Min. milliseconds/frame for sync
  70. Sorry, your browser doesn't support Java.    ; Message for no java browsers.
  71. </applet>                                    ; End of applet tag
  72.  
  73. *****************************************************************************
  74.  
  75. INSTRUCTIONS.
  76.  
  77. The following instructions describe how to change parameters:
  78.  
  79. Attempting to change the credits parameter will disable the applet.
  80.  
  81. To activate the reg parameters read the shareware registration notes.
  82. In the "regcode" parameter, place the registration code you purchased 
  83. from the author. If the code is correct and the applet is run from
  84. the registered domain name, you can use "link" parameters to link to a URL
  85. when the applet is "clicked".
  86.  
  87. If you set "regnewframe" to "YES", you can specify a specific frame location
  88. for the reglink:
  89.  
  90. "_blank"  : To load the link in a new blank unnamed browser window.
  91. "_self"   : To load the link into the same window the applet occupies.
  92. "_parent" : To load the link into the immediate FRAMESET parent.
  93. "_top"    : To load the link into the top body of the window.
  94.  
  95. You can also set a custom frame name, such as "myframe1".
  96.  
  97. With the "overimg" parameter you can specify the name of an image that will
  98. be painted over the applet. The best options are transparent GIF images.
  99.  
  100. NOTE: Animated GIF images are supported, but will be animated only on 
  101. latest browsers (Netscape 4 and Explorer 4 or newer).
  102.  
  103. With "overimgX" and "overimgY" you can center the image over the applet area.
  104.  
  105. The applet can be of any size. If res=1, remember to place the exact
  106. size of the image in "width" and "height" tags. If res=2, place doubled 
  107. values, if res=3 place triple values etc.
  108. (In fact, res is a sort of zoomer).
  109.  
  110. The image used as the texture can be of any size, but the preferred size is
  111. 256*256. Try to use GIF or JPG images with a size close to 256*256.
  112.  
  113. The "tunnelradius" determines the size of the tunnel.
  114.  
  115. You can change the lightning/shading of the tunnel with "lightmin", "lightmax",
  116. and "lightdec" parameters.
  117.  
  118. Yes can disable/enable shading with the "shade" parameter, and invert the
  119. shading with "lightinv".
  120.  
  121. You can enable a "square" mode, replacing the cylindrical one, with the
  122. parameter "squared".
  123.  
  124. The movement of the tunnel is determined by "tunrot" and "tunadvance"; whereas
  125. the movement of the observer is determined by "xrot","yrot","zrot".
  126.  
  127. You can enable interactive mode with "interactive" parameter: if set to
  128. "yes", users will be able to control the tunnel movements with a mouse pointer.
  129.  
  130. You can enable the tunnel morphing function by setting the "bends" parameter to
  131. "yes". 
  132.  
  133. You can control the bends with "bendoffset", "bendsizemin", "bendsizemax",
  134. "bendoffsetinc", and "bendsizeinc".
  135.  
  136.  
  137.